package cn.edu.qzuie.artist.module.td.service.student;

import java.util.*;

import cn.edu.qzuie.artist.module.td.controller.admin.student.vo.*;

import cn.edu.qzuie.artist.module.td.controller.admin.teacher.vo.TeacherExcelDataInputVO;
import cn.edu.qzuie.artist.module.td.controller.admin.teacher.vo.TeacherExcelRespVo;
import cn.edu.qzuie.artist.module.td.controller.app.student.vo.AppStudentAuthLoginRepVo;
import cn.edu.qzuie.artist.module.td.controller.app.student.vo.AppStudentAuthLoginRespVo;
import cn.edu.qzuie.artist.module.td.dal.dataobject.student.StudentDO;
import cn.edu.qzuie.artist.framework.common.pojo.PageResult;
import cn.edu.qzuie.artist.framework.common.pojo.PageParam;

import javax.validation.Valid;

/**
 * 学生 Service 接口
 *
 * @author 泉信管理员
 */
public interface StudentService {

    /**
     * 学号 + 密码登录
     *
     * @param reqVO 登录信息
     * @return 登录结果
     */
    AppStudentAuthLoginRepVo login(@Valid AppStudentAuthLoginRespVo reqVO);

    /**
     * 刷新访问令牌
     *
     * @param refreshToken 刷新令牌
     * @return 登录结果
     */
    AppStudentAuthLoginRepVo refreshToken(String refreshToken);

    /**
     * 创建学生
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createStudent(@Valid StudentSaveReqVO createReqVO);



    /**
     * 更新学生
     *
     * @param updateReqVO 更新信息
     */
    void updateStudent(@Valid StudentSaveReqVO updateReqVO);


    /**
     * 删除学生
     *
     * @param id 编号
     */
    void deleteStudent(Long id);

    /**
     * 获得学生
     *
     * @param id 编号
     * @return 学生
     */
    StudentDO getStudent(Long id);

    /**
     * 获得学生分页
     *
     * @param pageReqVO 分页查询
     * @return 学生分页
     */
    PageResult<StudentDO> getStudentPage(StudentPageReqVO pageReqVO);


    /**
     * 批量插入学生数据
     *
     * @param studentlist 待插入的学生信息列表
     * @throws Exception 插入过程中可能出现的异常，如数据库连接异常、数据格式错误等
     */
    StudentExcelRespVo batchInsertStudent(List<StudentExcelDataInputVO> studentlist, boolean isupdateSupport);
}